docs.cwtch.im/docs/platforms/tails.md

36 lines
1.7 KiB
Markdown
Raw Normal View History

2023-04-05 04:13:10 +00:00
---
sidebar_position: 1
---
# Running Cwtch on Tails
:::caution Nightly Feature
2023-04-05 04:13:59 +00:00
This functionality is currently available in the [Nightly Release](https://docs.cwtch.im/docs/contribute/testing#cwtch-nightlies) builds of Cwtch.
2023-04-05 04:13:10 +00:00
This functionality may be incomplete.
:::
The following steps requires that Tails has been launched with an [Administration password](https://tails.boum.org/doc/first_steps/welcome_screen/administration_password/).
Tails uses [Onion Grater](https://gitlab.tails.boum.org/tails/tails/-/blob/master/config/chroot_local-includes/usr/local/lib/onion-grater#L3) to guard access to the control port. We have packaged
an oniongrater configuration `cwtch-tails.yml` and setup script (`install-tails.sh`) with Cwtch on Linux.
The tails-specific part of the script is reproduced below:
# Tails needs to be have been setup up with an Administration account
#
# Make Auth Cookie Readable
sudo chmod o+r /var/run/tor/control.authcookie
# Copy Onion Grater Config
sudo cp cwtch.yml /etc/onion-grater.d/cwtch.yml
# Restart Onion Grater so the Config Takes effect
sudo systemctl restart onion-grater.service
When launching, Cwtch on Tails should be passed the `CWTCH_TAILS=true` environment variable to automatically configure Cwtch for running in a Tails-like environment. (The `cwtch.tails.sh` does this)
## Persistence
By default, Cwtch creates `$HOME/.cwtch` and saves all encrypted profiles and settings files there. In order to save any profiles/conversations in Cwtch on Tails you will have to backup this folder to a non-volatile home.
See the Tails documentation for setting up [persistent storage](https://tails.boum.org/doc/persistent_storage/)