This is the backend service for tab-ui. The current recommended way to run this is Docker.
Build the docker image using
docker build -t backtab .
Then, create the docker VM using:
docker create \
-v backtab:/srv/backtab \
-p 4903:4903 \
-e [email protected]:0x20/tab-data \
-e TEST_MODE=1 \
--name backtab \
--init \
backtab:latest
You'll almost certainly want to change the repo name, and for production use, you'll want to remove the TEST_MODE environment variable.
Once the container is created, you'll need to copy in an SSH private key that has push access to the remote repo. (For test mode, you can use HTTP and skip this step, or you can simply use an SSH key that only has read access):
docker cp /path/to/id_rsa backtab:/root/.ssh/
Finally, you can start the backend:
docker start backtab
This method is deprecated and the documentation is kept for historical purposes
Build a package using
dpkg-buildpackage --no-sign
Then, install it using
sudo dpkg -i ../backtab_1.1_all.deb
The systemd init script will likely fail to start if you configured
backtab to use a ssh:// url; if so, add your SSH private key to
/var/lib/backtab/.ssh and then backtab should start.
Check out a copy of your data repository wherever you find convenient.
We'll call that location /srv/backtab/tab-data.
Next, you'll need to create a virtualenv and install backtab:
python3 -mvenv /path/to/backtab.venv
. /path/to/backtab.venv/bin/activate
pip install .
Next, copy config.yml to somewhere convenient; in production I usually call
it backtab.yml. Edit it to your taste.
Finally, create a systemd unit for backtab:
[Unit]
Description=Tab backend
Wants=network.target
After=network.target
[Service]
User=hsg
Type=notify
NotifyAccess=main
ExecStart=/path/to/backtab.venv/bin/backtab-server -c /path/to/backtab.yml
StandardOutput=journal
[Install]
WantedBy=multi-user.target
Finally, enable and start it:
systemctl enable backtab.service
systemctl start backtab.service