{"id":42569807,"url":"https://github.com/simphony/simphony-remote","last_synced_at":"2026-01-28T21:05:34.423Z","repository":{"id":9356045,"uuid":"61792971","full_name":"simphony/simphony-remote","owner":"simphony","description":"A web service based on Jupyter Hub to spawn simphony aware docker containers that provide browser access (novnc)","archived":false,"fork":false,"pushed_at":"2022-12-27T14:56:29.000Z","size":3155,"stargazers_count":5,"open_issues_count":45,"forks_count":7,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-04-17T08:52:03.136Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simphony.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.rst","contributing":null,"funding":null,"license":"LICENSE.rst","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-06-23T09:30:59.000Z","updated_at":"2022-07-30T14:10:06.000Z","dependencies_parsed_at":"2023-01-11T20:11:59.911Z","dependency_job_id":null,"html_url":"https://github.com/simphony/simphony-remote","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/simphony/simphony-remote","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simphony%2Fsimphony-remote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simphony%2Fsimphony-remote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simphony%2Fsimphony-remote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simphony%2Fsimphony-remote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simphony","download_url":"https://codeload.github.com/simphony/simphony-remote/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simphony%2Fsimphony-remote/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28851838,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T15:15:36.453Z","status":"ssl_error","status_checked_at":"2026-01-28T15:15:13.020Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-28T21:05:33.630Z","updated_at":"2026-01-28T21:05:34.415Z","avatar_url":"https://github.com/simphony.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Simphony-remote\n===============\n\n.. image:: https://readthedocs.org/projects/simphony-remote/badge/?version=latest\n   :target: https://simphony-remote.readthedocs.io/en/latest/?badge=latest\n   :alt: Documentation Status\n\nThe Simphony-remote is web service that allows users to start and work with simphony enabled environments remotely.\n\nKey provided features:\n\n   - Isolated working environments using docker containers.\n   - No install remote access through a web browser.\n   - Sharing of working sessions.\n   - Based on community supported open source initiatives (JupyterHub)\n\nAcknowledgments\n---------------\n\nThis software is developed under the SimPhoNy project, an EU-project\nfunded by the 7th Framework Programme (Project number 604005) under\nthe call NMP.2013.1.4-1: \"Development of an integrated multi-scale\nmodelling environment for nanomaterials and systems by design\".\n\nDocumentation\n=============\n\nA quick setup guide is given below; please see the :doc:`documentation \u003c/index\u003e` for more\ndetailed information.\n\nDeployment (Quick Start)\n========================\n\nBasic instructions for a single-user deployment on a local (or virtual) machine are provided below.\nA more comprehensive deployment documentation, including use of a ``nginx`` reverse proxy and\nrunning as a service can be found :doc:`here \u003c/deployment\u003e`\n\nSingle Machine\n--------------\n\nIf you would like to test a deployment of S-R using Docker for CI purposes, then please use the following\n:doc:`instructions \u003c/developer/ci_instructions\u003e`.\n\n.. note::\n\n   The following instructions assume a clean up-to-date Ubuntu 18.04 or CentOS 7\n   system with ``git`` and ``make`` installed.\n\n#. Retrieve the required repository::\n\n     git clone https://github.com/simphony/simphony-remote.git\n\n#. Make sure that you have a recent version of Docker. This guide has been tested on version 19.03.5 (build 633a0ea838).\n   :code:`make deps` will install the latest version if you do not already have a version of docker available.\n   Full instructions available at the Docker website `for Ubuntu \u003chttps://docs.docker.com/engine/install/ubuntu/\u003e`_\n   and `for CentOS \u003chttps://docs.docker.com/engine/install/centos/\u003e`_ operating systems.\n   Docker installed using Ubuntu's Snap package manager might not work as expected; see\n   https://github.com/simphony/simphony-remote/issues/572 for details.\n   A Makefile rule is provided for convenience.\n   **NOTE: this overwrites the docker.list file you might have setup in your /etc/apt/sources.d/ directory**.\n   You might be prompted for the root password to execute this::\n\n     make deps\n\n#. Make sure your docker server is running, and your user is allowed to connect to\n   the docker server (check accessibility of ``/var/run/docker.sock``). You obtain this by\n   running::\n\n     sudo service docker start\n\n   followed by either::\n\n    (Ubuntu) sudo addgroup your_username docker\n    (CentOS) sudo groupmod -aG docker your_username\n\n   and logging out and in again. Check if your docker server is operative by running::\n\n     docker info\n\n#. Create and activate a virtual environment, then set the appropriate PATH for the node modules::\n\n     make venv\n     . venv/bin/activate\n     export PATH=`npm bin`:$PATH\n\n#. Install the python dependencies::\n\n     make pythondeps\n\n#. And install the package itself::\n\n     make install\n\n#. Generate the SSL certificates if you do not already have them. The\n   resulting certificates will have names test.* because they are\n   self-signed and **are not supposed to be used for production**.\n   A CA-signed certificate should be obtained instead.\n   The certificates will be created in the jupyterhub directory::\n\n     make certs\n\n#. Create the database. By default, this is a sqlite file::\n\n     make db\n\n#. If you are using virtual users (users that are not present on the system) you need to create\n   a temporary space where the virtual user homes are created::\n\n     mkdir /tmp/remoteapp\n\nThe installation is complete, you can now start the service.\n\nStart JupyterHub\n----------------\n\n#. Change dir into ``jupyterhub/``::\n\n     cd ./jupyterhub\n\n#. Verify that ``jupyterhub_config.py`` is correct for your deployment\n   machine setup (see :doc:`configuration \u003c/configuration\u003e` for more details).\n   Some example configuration files are provided in the\n   ``example_configurations/`` directory.\n\n#. Start JupyterHub by invoking the start script::\n\n     bash start.sh\n\n   .. note::\n      If you want to keep the application running, use screen to start\n      a detachable terminal.\n\n   .. note::\n      Running on OSX or with a separate docker machine requires that the\n      appropriate environment variables are set before starting jupyterhub.\n      refer to the command ``docker-machine env`` to setup the appropriate\n      environment. In general, invoking::\n\n            eval `docker-machine env`\n\n      will enable the appropriate environment.\n      On Linux, by default the host machine and the docker machine coincide,\n      so this step is not needed.\n\n#. JupyterHub is now running at https://127.0.0.1:8000\n\n   For many browsers this must be typed exactly as shown - using http://127.0.0.1:8000 or localhost:8000\n   will not work. As mentioned above, the self-signed SSL certificates should cause your browser to\n   raise a warning and require adding 127.0.0.1 to the list of security exceptions.\n\n   Currently, the only fully supported browser is Google Chrome/Chromium. The latest version of Firefox has shown\n   some issues with keyboard input when the vnc is running, however for the most part users will likley not\n   suffer any issues.\n\nSetting up Docker images\n------------------------\n\nNext, we need to obtain a docker image to run on Simphony-Remote. This can be done by either pulling an existing\nimage from a docker registry, or creating our own locally.\n\nTo create new images, please follow the documentation hosted at Horizon 2020\n`Simphony \u003chttps://github.com/simphony/simphony-remote-docker\u003e`_ project repository.\n\n\nSetup Database Accounting\n-------------------------\n\nA database is needed for managing the remote applications available for each user.\nNote that this database is in addition to the database created or used by JupyterHub.\n\nDefault sqlite database\n\n   **remoteappmanager** by default uses a sqlite database *remoteappmanager.db* in\n   the current work directory.  The **remoteappdb** command-line tool is provided\n   for setting up the database.  Please refer to the :doc:`utilities \u003c/utilities\u003e`\n   section for details on the use of this program.\n\n\nSetting up Users\n----------------\n\nWhilst Simphony-Remote is running using the standard ``jupyter_config.py`` script,\nnavigate to https://127.0.0.1:8000 in your browser and login with the username 'admin' and no password. Select the\n'Users' tab on the left hand menu and click the 'Create New Entry' button in the top right. Make up a username and\nclick submit. \n\nNext, click the Applications tab in the left hand menu and click the 'Create New Entry' button in the top right.\nWe can add the name of any docker image available to the Docker daemon.\n\nThen go back to the 'Users' tab, select the 'Policies' button next to the username. Create a new entry and choose\nthe added image name from the dropdown menu. Nothing else needs to be set, unless you want to mount a directory\nwithin the docker container.\n\nLog out of SimphonyRemote (red 'admin' button in the top right) and log in using the username you specified for your\nnew user and no password, you should now be able to start your application!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimphony%2Fsimphony-remote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimphony%2Fsimphony-remote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimphony%2Fsimphony-remote/lists"}