From f186b71ca51e83837db60de13322394bb5e6d348 Mon Sep 17 00:00:00 2001 From: murilo ijanc Date: Tue, 24 Mar 2026 21:41:06 -0300 Subject: Initial commit Import existing tesseras.net website content. --- book/en/commands/init.html | 288 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 288 insertions(+) create mode 100644 book/en/commands/init.html (limited to 'book/en/commands/init.html') diff --git a/book/en/commands/init.html b/book/en/commands/init.html new file mode 100644 index 0000000..0c1db91 --- /dev/null +++ b/book/en/commands/init.html @@ -0,0 +1,288 @@ + + + + + + init - Tesseras User Guide + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+

Keyboard shortcuts

+
+

Press or to navigate between chapters

+

Press S or / to search in the book

+

Press ? to show this help

+

Press Esc to hide this help

+
+
+
+
+ + + + + + + + + + + + + +
+ +
+
+ + + + + + + +
+
+

tes init

+

Initialize identity and local database.

+

Usage

+
tes init
+
+

Description

+

Sets up your local Tesseras environment. This is the first command you should run after installing Tesseras.

+

The command creates:

+
+ + + + + + + + + + +
PathContents
~/.tesseras/identity/Ed25519 keypair for signing tesseras
~/.tesseras/db/SQLite database for indexing
~/.tesseras/blobs/Blob storage for memory files
~/.tesseras/config.tomlConfiguration file
+
+

Options

+
+ + + + + + + +
OptionDescription
--data-dir <PATH>Base directory for data storage (default: ~/.tesseras)
+
+

Idempotent

+

Running init again is safe. If an identity already exists, it is preserved:

+
tes init
+
+
Ed25519 identity already exists
+Database initialized
+Tesseras initialized at /home/user/.tesseras
+
+

Custom data directory

+
tes --data-dir /mnt/usb/tesseras init
+
+

This creates the full directory structure under /mnt/usb/tesseras/ instead of the default location.

+

What happens under the hood

+
    +
  1. Creates the directory structure (identity/, db/, blobs/)
  2. +
  3. Generates an Ed25519 keypair (private key stays local, public key identifies you)
  4. +
  5. Runs SQLite migrations to set up the database schema
  6. +
  7. Writes a default config.toml
  8. +
+ +
+ + +
+
+ + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
+ + -- cgit v1.2.3