Neurodesk App is the cross-platform desktop application for Neurodesk. It is the quickest and easiest way to get started with Neurodesk on your personal computer, with the flexibility for advanced use cases.
Neurodesk App requires Docker to be installed on your computer. If you already have Docker installed, you can skip this step.
After installation, open a terminal (Linux/macOS) or command prompt (Windows) and run the following command to verify that Docker is working correctly:
docker --version
If you have an existing Neurodesk App installation, please uninstall it first by following the uninstall instructions.
- Debian, Ubuntu Linux Installer
- Red Hat, Fedora, SUSE Linux Installer
- Arch-based package via AUR
- macOS Intel Installer, macOS Apple silicon Installer
- Windows Installer
⚠️ On Microsoft edge, follow these steps to download the executable file:
Neurodesk App can be launched from the GUI of your operating system by clicking the application's icon or by using neurodeskapp command from the command line.
Neurodesk App sets File Browser's root directory based on the launch method.
-
If launched from the application icon on GUI or by using
neurodeskappcommand without any arguments, then the default working directory is set as the root directory. The default working directory is user home directory but it can be customized from the Settings dialog. -
If
neurodeskappcommand is used with a directory path as the argument or with the--working-dirargument the directory in the argument is set as the root directory.
Sessions represent local project launches and connections to existing Neurodesk servers. Each Neurodesk UI window in the app is associated with a separate session and sessions can be restored with the same configuration later on.
Each launch of Neurodesk in a different working directory is a separate project and projects can have their own configuration such as Python environment and UI layout.
You can start a new session by using the links at the Start section of the Welcome Page.
Open Local Neurodesk..creates a new session in the default working directory.Connect...creates a session by connecting to a remote Neurodesk server.
Previously opened sessions are stored as part of application data and they are listed on Welcome Page. Clicking an item in the Recent sessions list restores the selected session.
Neurodesk App stores its data in the following locations:
-
By default, /home/jovyan/neurodesktop-storage in the app (which is binded with local directory ~/neurodesktop-storage in Unix or C:/neurodesktop-storage in Windows)
-
By choice, in the setting window below, select
Additional Directoryon the left side bar, clickChangebutton to select the local directory, then clickApply & restart. The next time you start the app, the data from the local directory can be found in /home/jovyan/data.
