This commit is contained in:
djmitche
2025-10-11 18:57:46 +00:00
parent 770c3cdc98
commit 88095c17d7
4 changed files with 37 additions and 11 deletions

View File

@ -204,7 +204,7 @@ build and run the taskchampion-sync-server binary directly. See
</ul> </ul>
<div style="break-before: page; page-break-before: always;"></div><h1 id="docker-compose"><a class="header" href="#docker-compose">Docker Compose</a></h1> <div style="break-before: page; page-break-before: always;"></div><h1 id="docker-compose"><a class="header" href="#docker-compose">Docker Compose</a></h1>
<p>The <p>The
<a href="https://raw.githubusercontent.com/GothenburgBitFactory/taskchampion-sync-server/refs/tags/v0.7.0/docker-compose.yml"><code>docker-compose.yml</code></a> <a href="https://raw.githubusercontent.com/GothenburgBitFactory/taskchampion-sync-server/refs/tags/v0.7.1/docker-compose.yml"><code>docker-compose.yml</code></a>
file in this repository is sufficient to run taskchampion-sync-server, file in this repository is sufficient to run taskchampion-sync-server,
including setting up TLS certificates using Lets Encrypt, thanks to including setting up TLS certificates using Lets Encrypt, thanks to
<a href="https://caddyserver.com/">Caddy</a>. This setup uses the SQLite backend, which is <a href="https://caddyserver.com/">Caddy</a>. This setup uses the SQLite backend, which is
@ -293,15 +293,28 @@ httpd.</p>
<li><code>taskchampion-sync-server</code> (SQLite)</li> <li><code>taskchampion-sync-server</code> (SQLite)</li>
<li><code>taskchampion-sync-server-postgres</code> (Postgres)</li> <li><code>taskchampion-sync-server-postgres</code> (Postgres)</li>
</ul> </ul>
<h3 id="building-the-binary"><a class="header" href="#building-the-binary">Building the Binary</a></h3>
<p>This is a standard Rust project, and can be built with <code>cargo build --release</code>.</p>
<p>By default, only the SQLite binary is built. To also build the Postgres binary,
use</p>
<pre><code class="language-none">cargo build --release --features postgres
</code></pre>
<p>To disable building the SQLite binary and build only the Postgres binary, use</p>
<pre><code class="language-none">cargo build --release --no-default-features --features postgres
</code></pre>
<h3 id="running-the-binary"><a class="header" href="#running-the-binary">Running the Binary</a></h3> <h3 id="running-the-binary"><a class="header" href="#running-the-binary">Running the Binary</a></h3>
<p>The server is configured with command-line options or environment variables. <p>The server is configured with command-line options or environment variables.
See the <code>--help</code> output for full details.</p> See the <code>--help</code> output for full details.</p>
<p>For the SQLite binary, the <code>--data-dir</code> option or <code>DATA_DIR</code> environment <p>For the SQLite binary, the <code>--data-dir</code> option or <code>DATA_DIR</code> environment
variable specifies where the server should store its data. For the Postgres variable specifies where the server should store its data.</p>
binary, the <code>--connection</code> option or <code>CONNECTION</code> environment variable <p>For the Postgres binary, the <code>--connection</code> option or <code>CONNECTION</code> environment
specifies the connection information, in the form of a <a href="https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING-URIS">LibPQ-style connection variable specifies the connection information, in the form of a <a href="https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING-URIS">LibPQ-style
connection
URI</a>. URI</a>.
The remaining options are common to all binaries.</p> Note that unlike LibPQ, the Rust client only supports <code>sslmode</code> values
<code>disable</code>, <code>prefer</code>, and <code>require</code>, and will always validate CA hostnames and
certificates when using TLS.</p>
<p>The remaining options are common to all binaries.</p>
<p>The <code>--listen</code> option specifies the interface and port the server listens on. <p>The <code>--listen</code> option specifies the interface and port the server listens on.
It must contain an IP-Address or a DNS name and a port number. This option is It must contain an IP-Address or a DNS name and a port number. This option is
mandatory, but can be repeated to specify multiple interfaces or ports. This mandatory, but can be repeated to specify multiple interfaces or ports. This

File diff suppressed because one or more lines are too long

View File

@ -165,15 +165,28 @@ httpd.</p>
<li><code>taskchampion-sync-server</code> (SQLite)</li> <li><code>taskchampion-sync-server</code> (SQLite)</li>
<li><code>taskchampion-sync-server-postgres</code> (Postgres)</li> <li><code>taskchampion-sync-server-postgres</code> (Postgres)</li>
</ul> </ul>
<h3 id="building-the-binary"><a class="header" href="#building-the-binary">Building the Binary</a></h3>
<p>This is a standard Rust project, and can be built with <code>cargo build --release</code>.</p>
<p>By default, only the SQLite binary is built. To also build the Postgres binary,
use</p>
<pre><code class="language-none">cargo build --release --features postgres
</code></pre>
<p>To disable building the SQLite binary and build only the Postgres binary, use</p>
<pre><code class="language-none">cargo build --release --no-default-features --features postgres
</code></pre>
<h3 id="running-the-binary"><a class="header" href="#running-the-binary">Running the Binary</a></h3> <h3 id="running-the-binary"><a class="header" href="#running-the-binary">Running the Binary</a></h3>
<p>The server is configured with command-line options or environment variables. <p>The server is configured with command-line options or environment variables.
See the <code>--help</code> output for full details.</p> See the <code>--help</code> output for full details.</p>
<p>For the SQLite binary, the <code>--data-dir</code> option or <code>DATA_DIR</code> environment <p>For the SQLite binary, the <code>--data-dir</code> option or <code>DATA_DIR</code> environment
variable specifies where the server should store its data. For the Postgres variable specifies where the server should store its data.</p>
binary, the <code>--connection</code> option or <code>CONNECTION</code> environment variable <p>For the Postgres binary, the <code>--connection</code> option or <code>CONNECTION</code> environment
specifies the connection information, in the form of a <a href="https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING-URIS">LibPQ-style connection variable specifies the connection information, in the form of a <a href="https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING-URIS">LibPQ-style
connection
URI</a>. URI</a>.
The remaining options are common to all binaries.</p> Note that unlike LibPQ, the Rust client only supports <code>sslmode</code> values
<code>disable</code>, <code>prefer</code>, and <code>require</code>, and will always validate CA hostnames and
certificates when using TLS.</p>
<p>The remaining options are common to all binaries.</p>
<p>The <code>--listen</code> option specifies the interface and port the server listens on. <p>The <code>--listen</code> option specifies the interface and port the server listens on.
It must contain an IP-Address or a DNS name and a port number. This option is It must contain an IP-Address or a DNS name and a port number. This option is
mandatory, but can be repeated to specify multiple interfaces or ports. This mandatory, but can be repeated to specify multiple interfaces or ports. This

View File

@ -157,7 +157,7 @@
<main> <main>
<h1 id="docker-compose"><a class="header" href="#docker-compose">Docker Compose</a></h1> <h1 id="docker-compose"><a class="header" href="#docker-compose">Docker Compose</a></h1>
<p>The <p>The
<a href="https://raw.githubusercontent.com/GothenburgBitFactory/taskchampion-sync-server/refs/tags/v0.7.0/docker-compose.yml"><code>docker-compose.yml</code></a> <a href="https://raw.githubusercontent.com/GothenburgBitFactory/taskchampion-sync-server/refs/tags/v0.7.1/docker-compose.yml"><code>docker-compose.yml</code></a>
file in this repository is sufficient to run taskchampion-sync-server, file in this repository is sufficient to run taskchampion-sync-server,
including setting up TLS certificates using Lets Encrypt, thanks to including setting up TLS certificates using Lets Encrypt, thanks to
<a href="https://caddyserver.com/">Caddy</a>. This setup uses the SQLite backend, which is <a href="https://caddyserver.com/">Caddy</a>. This setup uses the SQLite backend, which is