This guide was written for UberLab by me. This is just a copy but maybe it is more up-to-date due to the fact that is’s easier for me to update this site, than the UberLab. I am trying to keep both side up-to-date.
For this guide you need some tools:
Set up the backends:
[isabell@stardust ~]$ uberspace web backend set / --http --port 3000 Set backend for / to port 3000; please make sure something is listening! You can always check the status of your backend using "uberspace web backend list".
Now let’s get started with Cryptpad.
We’re using Node.js in the stable version 10:
[isabell@stardust ~]$ uberspace tools version use node 10 Selected Node.js version 10
We also need Bower:
[isabell@stardust ~]$ npm install -g bower
[isabell@stardust ~]$ git clone --branch 2.21.0 https://github.com/xwiki-labs/cryptpad.git ~/cryptpad Cloning into '~/cryptpad'... remote: Enumerating objects: 172, done. remote: Counting objects: 100% (172/172), done. remote: Compressing objects: 100% (105/105), done. remote: Total 43165 (delta 99), reused 109 (delta 67), pack-reused 42993 Receiving objects: 100% (43165/43165), 85.51 MiB | 4.81 MiB/s, done. Resolving deltas: 100% (30989/30989), done. Note: checking out '135182ea0a3500d27afe0146c94e112e1726ae7e'. You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by performing another checkout. If you want to create a new branch to retain commits you create, you may do so (now or later) by using -b with the checkout command again. Example: git checkout -b <new-branch-name> Checking out files: 100% (4319/4319), done.
Now we need to install some dependencies:
[isabell@stardust ~]$ cd ~/cryptpad [isabell@stardust cryptpad]$ npm install (...) added 168 packages from 186 contributors and audited 311 packages in 14.352s found 0 vulnerabilities [isabell@stardust cryptpad]$ bower install (...) bower install open-sans-fontface#1.4.2 bower install jquery#2.1.4 bower install bootstrap#4.3.1 (...)
Copy example configuration
[isabell@stardust cryptpad]$ cp config/config.example.js config/config.js
config/config.js and change the value of the variable
_domain to your domain, like so:
/* globals module */ var _domain = 'https://isabell.uber.space/';
~/etc/services.d/cryptpad.ini with the following content:
[program:cryptpad] directory=%(ENV_HOME)s/cryptpad command=node server autorestart=yes
Now let’s start the service:
After creating the configuration, tell supervisord to refresh its configuration and start the service:
[isabell@stardust ~]$ supervisorctl reread SERVICE: available [isabell@stardust ~]$ supervisorctl update SERVICE: added process group [isabell@stardust ~]$ supervisorctl status cryptpad RUNNING pid 26020, uptime 0:03:14
For any futher configuration or customization you should have a look at the Cryptpad Wiki.
Check the update feed regularly to stay informed about the newest version
If there is a new version available, you can get the code using git. Replace the version number
2.19.0 with the latest version number you got from the release feed:
[isabell@stardust ~]$ cd ~/cryptpad [isabell@stardust cryptpad]$ git pull origin 2.19.0 From https://github.com/xwiki-labs/cryptpad * tag 2.19.0 -> FETCH_HEAD Already up to date.
Then you need to restart the service, so the new code is used by the webserver:
[isabell@stardust cryptpad]$ supervisorctl restart cryptpad
Last tested: with Cryptpad 2.24.0 and Uberspace 184.108.40.206