Popular topics

The OrbitOne model

OrbitOne separates personal content from collaboration in workspaces. This means that private notes, appointments and access remain private, while team content is clearly assigned to a workspace.

A typical connected flow

1. 1
   Retain knowledge

   A grade contains meeting results and a checklist.

2. 2
   derive work

   A checklist item is linked to a task and assigned to a person.

3. 3
   Schedule time

   The due date appears on the calendar; Files and docs are directly linked to the task.

4. 4
   Synchronize completion

   When the task is completed, OrbitOne also updates the linked checklist.

1. Log in and open your client

Open your company's address, for example https://firma.orbitone.pro. After logging in, OrbitOne loads the most recently used tenant and workspace.

2. Complete profile

1. Open profile menu. Click on your name at the bottom left.
2. Check personal information. Enter your name, language and, if necessary, a profile picture.
3. Choose notifications. Activate targeted browser, drive or email notifications.
4. Increase security. Use MFA or a passkey if offered.

You only need personal access tokens for connected clients like the Vault Browser add-on. Treat it like a password.

3. Select workspace

Under Work areas you can see all the workspaces you have access to. After selection, the navigation of this workspace appears on the left with the activated modules.

4. Create your first content

Open the desired module and click New or the blue plus button. If a feature is missing, the module may not have been activated for the workspace or you may not have write permission.

5. Optional: Connect clients

Personal areas

At the top of the navigation you will find content that belongs to your user account. These views can also bring together entries from your workspaces, such as assigned tasks or displayed workspace calendars.

• Dashboard: compact overview of current work.
• My tasks: assigned and personal tasks.
• My appointments: personal calendar with optional workspace calendars.
• My Notes and My Vault: private content.

Active workspace

Only the modules that are activated there and that you are allowed to access are displayed under the name of the active workspace. A workspace change completely changes this area of ​​navigation.

Three-dot menus and UIDs

Actions that are needed less often are behind the three-point menu. Depending on the entry, you will find, among other things, deletion, moving, linking and the technical UID. The UID is particularly useful for support cases or external integrations.

Back and Deep Links

OrbitOne updates the browser history when changing pages internally. You can therefore use the browser's back button and share links to tasks, notes, docs or other entries directly, provided the person receiving them has the necessary rights.

When a workspace makes sense

Create your own workspace if content requires a common authorization limit, its own task processes or a separate file and knowledge base. Typical examples are departments, customer projects, products or internal services.

Activate modules

Workspace administrators can control which spaces are available in Settings. This includes documentation, files, vault, tasks, appointments, notes, repositories and individually configured areas.

Permission model

Rights may also be restricted per module. Write permissions in Docs do not automatically mean write permissions in the Vault.

Connect content

Many OrbitOne entries can be linked to one another. For example, in a task you can reference a note, a doc, a file, a repo commit or an appointment. The link does not assume any rights: users only see the target if they are allowed to access it.

Docs or Notes?

Edit rich text

The shared editor supports text formatting, links, tables, code blocks, checklists, emojis, mentions, images and file attachments. Blocks can be rearranged using their handles.

Code blocks

For multi-line source code, use a block of code instead of individual inline code elements. Line breaks and indentations are retained as a continuous block.

async function loadWorkspace(workspaceId) {
  const response = await api.get(`/workspaces/${workspaceId}`);
  return response.data;
}

Mention people

Type @ and start with a person's name. Select the appropriate match from the autocomplete. Mentioned people can be notified depending on their personal settings.

Connect checklists to tasks

1. Create a checklist entry in a workspace note.
2. Mention with @Name the responsible person or use the task action on the entry.
3. OrbitOne creates or links the task; the task link remains outside the editable text.
4. Checking off the task and checklist is synchronized in both directions.

Watch note

Activate Watchif you would like to be informed about relevant changes to a grade. Workspace notes are marked as such in the header area so that they are not confused with private notes.

Create task

1. Open My tasks or the task module of a workspace.
2. Click on task or the plus symbol.
3. Assign title, type, status, priority, assignment and, if necessary, a due date.
4. Add a rich text description, files, screenshots and links.
5. Save the task. The detailed view opens without the task list next to it.

List, board and status

You can sort in the list; OrbitOne remembers the last sorting per user. The board view allows tasks to be moved between appropriate status columns.

Workspace administrators define which status values as active apply. Completed or otherwise inactive tasks can still be found using the corresponding filter view. Priorities can also have a row background color.

Process multiple tasks

Mark tasks using the selection fields. You can then change the status, move tasks to a different target area or delete multiple entries. OrbitOne only shows actions for which you have the necessary rights.

Comments, internal notes and attachments

Comments are created in their own dialog and support rich text, screenshots and files. In email tickets you can also choose whether a post is sent as a reply or just saved as an internal note in the task.

Workspace as a ticket system

Workspace administrators can convert incoming messages into tasks. The generated OrbitOne address and, depending on the configuration, IMAP, POP3 or Exchange Online are available for this. Sending can take place via SMTP or Exchange Online.

1. Open Workspace → Settings → Email.
2. Choose the retrieval method and only enter the access data displayed.
3. Specify the sender, shipping method and optional header and footer.
4. Test retrieval and dispatch before enabling processing.

Assignments and Rights

Users with write permissions in the Tasks module can assign tasks to authorized workspace members. If saving seems to have no results, first check the module rights and whether mandatory fields from the workspace configuration are fulfilled.

Use file browser

The folder navigation on the left determines the contents of the file list. On the right you will find the file type, uploader, modification time and associated OrbitOne items. On small screens, the table changes to a more compact display.

Upload files

1. Open the destination folder.
2. Click on Upload and select one or more files.
3. Leave the page open until the upload is confirmed.
4. If necessary, link the file to a note, doc, task, appointment, or repo entry.

Larger files are transferred via object storage. OrbitOne displays the status during this and only creates the visible file entry after successful completion.

Versions and download

If an existing file is updated, its version history is retained. If you are unsure, download an older version instead of overwriting the current version.

Linked content

The column Linked to leads directly to the associated Docs, Notes, Tasks and other elements. Conversely, you can select files via the rich text editor or the link dialog of an entry.

Download

The macOS version is installed via the Mac App Store and updated automatically. On Windows you can use the integrated update check under Manufacturer & Support.

Set up

1. Install OrbitOne Drive and log in with your OrbitOne account.
2. Select the local sync folder and the desired clients or workspaces.
3. If necessary, activate the Finder shortcut or, in Windows, a free drive letter.
4. Wait for the full match on the first run. Drive then uses the central file and version structure for quick subsequent synchronizations.

Understand status

Progress and activity appear on both the home page and in the compact sidebar widget. The client remains operable during synchronization.

Important protection mechanisms

Folders or files in reserved locations in the sync root will not be uploaded. Drive displays a notice and, if possible, offers to move to a permitted location.

Resolve conflicts

If changes are made at the same time, Drive saves both versions and creates a conflict copy with a time stamp. Compare the files, apply the desired changes and only then remove the copy that is no longer needed.

If Drive doesn't respond

1. Open History and check the last action.
2. Check under Settingswhether sync and repo folders can be reached.
3. Lead under Manufacturer & Support the version check.
4. Quit and restart the app. If it gets stuck, send the relevant log extract to support.

Prepare Git access

OrbitOne exposes each repository as a Git Smart HTTP remote over HTTPS. It allows you to use regular Git on the command line, an IDE, or a desktop client.

1. In OrbitOne Web, open the desired workspace and then the repository.
2. Copy in area Git Smart HTTP the preferred remote URL.
3. Choose Create Git token, give it a clear name and limit the token to this repository.
4. Activate repo:read for cloning and pulling. For pushes additional repo:write needed.
5. Immediately copy the displayed token to a safe location. The full value will not be displayed again later.

Clone existing repository

Replace the example URL with the remote URL from your repository detail. Git asks for your username and password the first time you access it.

git clone https://git.orbitone.pro/{mandant}/{repository}.git
cd {repository}
git status
git log --oneline --decorate -10

After the clone shows git remote -v the stored OrbitOne remote. By default it has the name origin.

Upload local project for the first time

If your project is not yet a Git repository, initialize it locally and then connect it to the empty OrbitOne repository:

cd /pfad/zu/deinem-projekt
git init
git add .
git commit -m "Initialer Projektstand"
git branch -M main
git remote add origin https://git.orbitone.pro/{mandant}/{repository}.git
git push -u origin main

If a Git repository already exists locally, this is omitted git init and the initial commit. Check with me git remote -vwhether there is already a remote named origin is present. If so, you can specifically reset your URL:

git remote set-url origin https://git.orbitone.pro/{mandant}/{repository}.git
git branch -M main
git push -u origin main

Daily workflow

Before making new changes, get the current status. Then review your changes, create a meaningful commit and push it to OrbitOne:

git pull --ff-only
git status
git add .
git commit -m "Kurze Beschreibung der Änderung"
git push

With git add datei.ext or git add ordner/ you can only specifically record certain changes. Check before committing git diff those not yet reserved and with git diff --staged the noted changes.

Save your registration securely

Git can manage credentials through the operating system's secure credential store. On macOS, the keychain is usually used for this; Git Credential Manager does this on Windows. Confirm storage only on your own device.

# macOS: Schlüsselbund-Helfer aktivieren
git config --global credential.helper osxkeychain

# Konfiguration prüfen
git config --global --get credential.helper

Instantly revoke a token in OrbitOne if it has been exposed or a device is no longer trusted. Then create a new token and update the entry in the credential store.

Common Git Issues

Verified with real Git

For the practical test OrbitOne Git Launch Demo created, cloned into an empty working copy and pushed with an initial commit. A second independent working copy was cloned, modified, and pushed again. The subsequent one git pull --ff-only brought both copies to exactly the same commit and file tree.

Install VS Code extension

Connect project

1. Open the repository in OrbitOne Web and download the VS Code configuration.
2. Put the created file as .vscode/orbitone.json in the project.
3. Open the project folder in VS Code and log in using the OrbitOne extension.
4. Check the status. The extension shows whether your local status is up to date.

Commit and pull

You can commit individual files, folders or the entire project. During commit, pull and version download, the extension shows an animated status. After a successful commit, the change badge is updated.

Exclude files

Use .gitignore or .gitskip for generated and local files. Folder like .git, .history, .vscode and node_modules are not transferred as project content by default.

Repo download in Drive

OrbitOne Drive can download repositories as a local working copy. In the client's repo overview you can see the current status, update or remove the local download. If the folder is deleted manually, the local entry also disappears, but the online version remains.

Download

The iOS app is available on the App Store and the Android app on Google Play. There is deliberately no direct download outside the stores.

The app at a glance

Features

• Change clients and workspaces
• Edit notes, docs, tasks and appointments
• Create content via quick entry
• Use Vault and password autofill
• Receive push notifications

Personal and Workspace Vault

Single or multiple entries can be moved to any vault that you are allowed to write to. This also applies across clients; OrbitOne checks the target right for each entry.

Install browser add-on

Chrome, Edge, Firefox and Safari automatically update the released store versions.

Establish connection

1. Create a personal access token under your profile in OrbitOne Web.
2. Open the browser add-on settings.
3. Enter your OrbitOne address and token and test the connection.
4. The add-on automatically loads all of the account's tenants, personal vaults and permitted workspace vaults.
5. Select the desired standard vault and subfolder for each tenant.

Autofill and new access data

If there is a clear domain hit, the add-on automatically fills in empty login fields. If there are several hits, you choose the appropriate access. After successful registration, the add-on can offer new or changed access data to save.

In the save dialog you specify the client, vault and subfolder. About Ignore this access Remember a page or combination so that the request doesn't appear there every time you log in.

Password tools

The add-on can generate strong passwords, assess their security, and view the age and history of a saved password. Older values ​​are only used for traceable recovery and should not be used again.

Import and export

Tenant administrators can find the wizard in the tenant configuration. Supported include Chrome, Edge, Firefox, KeePass, FileZilla, LastPass and OrbitOne. Before importing, you can select each access individually and assign it to a personal or workspace vault.

Views

Month, week, day, list and timeline are available. OrbitOne remembers the most recently used view separately for the personal calendar and each workspace calendar.

In calendar views, you can drag and drop editable individual appointments and adjust start and end times by dragging. For recurring appointments, OrbitOne first opens the selection for the affected appointment or series.

Create appointment

An appointment can contain subject, rich text description, location, meeting link, time period, all-day status, type, categories, participants, series and reminders. Link to Notes, Docs, Tasks, Repositories, Commits, Files, Vault Entries, or external URLs if necessary.

Tasks in the calendar

Tasks with relevant dates automatically appear in the calendar. Changes to the automatically generated calendar entry are traced back to the task, as long as the edited field belongs to the task.

Show workspace calendar personally

1. Open My appointments.
2. Open the filters and activate the desired workspaces.
3. If necessary, narrow down by type or category.
4. Optionally create an individual calendar URL for the current selection.

iCal or CalDAV?

Copy the URL generated by OrbitOne completely into the calendar client. The URL contains a personal access key and must be kept confidential. If you suspect sharing, revoke the release and create a new one.

Create CalDAV access in OrbitOne

1. In OrbitOne Web, open your personal calendar or desired workspace calendar.
2. Click on Calendar URLs and create a new release. Activate Allow editingif you want to transfer changes from Apple Calendar or Outlook back to OrbitOne.
3. Copy the complete one using the calendar symbol CalDAV URL. It ends with /calendar/.
4. Copy using the key symbol CalDAV access key. It is only valid for this calendar share and can be revoked later.

Set up Apple Calendar

On Mac

1. Open Calendar and choose Calendar → Add account.
2. Choose Other CalDAV account and as account type Manually.
3. Enter your OrbitOne email address as your username and your CalDAV access key as your password.
4. Enter the full OrbitOne CalDAV URL as the server address and confirm with Sign in.
5. As a test, create an appointment in this calendar. It should also appear in OrbitOne after the next sync.

On iPhone and iPad

1. Open Settings → Apps → Calendar → Calendar Accounts → Add Account → Other.
2. Choose Add CalDAV account.
3. Enter the full CalDAV URL, your OrbitOne email address and the CalDAV access key.
4. Save the account and check Apple Calendar to see if OrbitOne Calendar is enabled.

Set up Outlook with CalDAV for Outlook

For two-way synchronization with classic Outlook for Windows, use the free add-in Outlook CalDav Synchronizer. However, an iCal link added as an Internet calendar remains read-only.

1. Load Outlook CalDav Synchronizer Download, install the add-in and restart Outlook.
2. Open the tab in Outlook CalDav Synchronizer and click on Synchronization Profiles.
3. Click on +, choose Generic CalDAV/CardDAV and assign a profile name, for example “OrbitOne”.
4. Choose among Outlook folder the Outlook calendar folder to sync with OrbitOne.
5. Wear under DAV URL Enter the full OrbitOne CalDAV URL. The URL must end with a slash.
6. Enter your OrbitOne email address and CalDAV access key. Then click on Test or discover settings and select the calendar resource found.
7. Position as synchronization mode Outlook ↔ Server (Two-Way) on, save the profile and start with Synchronize now the first comparison.

Check two-way sync

1. Create a test appointment in OrbitOne and synchronize the calendar client. The appointment must appear there.
2. Change the subject or time in the calendar client and sync again. The change must be visible in OrbitOne.
3. Then create a second appointment directly in the OrbitOne calendar in the calendar client and check it in OrbitOne Web.

Changes are only possible if approved Allow editing was created and you have write permissions for the workspace in question. Automatically generated reminders about expiration dates are processed on the associated doc, file or Vault entry, not directly in the calendar client.

Memories

Appointments can have in-app and email reminders. A reminder will only be sent to participants who are assigned to the appointment and who have activated the respective channel in their personal notification settings.

Global search

The search only takes into account content for which you have read rights. Filter results by workspace and content type when a term appears in Notes, Docs, Tasks, Files, and other modules.

Typical triggers

• You will be mentioned in a rich text.
• A task will be assigned to you.
• A watched assignment or grade receives a new post.
• An activated appointment reminder is due.
• A ticket assigned to you is created from an email.

Set channels

Open your profile settings and activate the desired channels. OrbitOne also respects this selection for tasks and comments; a deactivated email notification may not be bypassed by a module action.

Test notifications

1. Activate at least the desired channel in your profile.
2. Allow OrbitOne Web or Drive notifications in the operating system.
3. Have a second user assign you a test task or send you a mention.
4. Check the in-app center, system notifications and, if necessary, spam folders.

Administrative levels

Assign users via email domain

Tenant administrators can be found at Client → Domains & Login the email domain and the automatic association switch. Only if the switch is active will OrbitOne consider the tenant for new registrations with this domain.

1. Wear the business email domain without it @ one, for example beispiel.de.
2. Activate Automatically assign new verified accounts to this email domain.
3. Save the domain and login settings.
4. A new user registers with a suitable address and receives a six-digit one-time code by email.
5. Only after successful code confirmation will OrbitOne create the account and assign it as a member.

Configure tasks

Administrators can define types, statuses, priorities and other parameters. For each status it is determined whether tasks appear in active or inactive lists. Priorities can be highlighted with a subtle row background color.

Security areas

Create backup

1. Open the advanced backup features of the appropriate settings layer.
2. Select the area and content granularly, for example only notes or individual repositories.
3. Check the estimated storage requirements. The backup counts towards the quota while it is retained.
4. Start the background job and download the package when finished.

By default, created backups are kept for a limited time. Vault content remains encrypted. Password hashes, sessions, API tokens, and calendar share tokens are not exported.

Restore

When restoring, choose again granularly which components will be adopted. Before starting, check the target assignment and the conflict behavior, for example merging or skipping an existing entry.

Check first

1. Reload the page completely once.
2. Check whether the correct client and workspace are active.
3. Check your rights for the affected module.
4. Test whether the problem also occurs in a private browser window.
5. Note the time, action, affected entry and visible error message.

401, 403 and 500

Upload stops

Check file size, network and free tenant storage. For screenshots in rich text, wait for the visible upload confirmation before saving the entry. If an error occurs, remove the failed attachment and restart only this upload.

Drive doesn't sync

Open History and Settings, check login and local paths, and run the version checker. A local repo folder may be removed without risk to the online version. For repeated transfers of the same file, the file name, timestamp and last history lines help support.

Vault add-on says “Please log in first”

1. Remove an accidental trailing path from the OrbitOne address; use the client base address.
2. Create a new personal token and paste it without spaces.
3. Click on Test connection.
4. Then check whether all clients and their personal vaults are loaded.

iCal or CalDAV does not work

• Check whether you really do CalDAV URL and don't use the read-only iCal URL.
• Use your OrbitOne email address and the CalDAV access key; a passkey, OTP or API token is not a CalDAV password.
• Copy the URL in its entirety including the final one /.
• For write access, check the option Allow editing and your workspace writing permissions.
• Remove a permanently incorrect account or synchronization profile and set it up again after revoking and recreating the sharing.