Skip to main content

remi code

Show or refresh the remote access connection code used for relay-based connections.

Show Current Code​

remi code

Displays the current permanent connection code:

Permanent connection code: AXBY-1234
Use --permanent-code flag when starting daemon to enable this code.

Note: By default, codes rotate on each reconnect. Use --permanent-code to
persist a fixed code (requires Ed25519 authentication for relay connections).

If no code exists yet, one is generated automatically.

Refreshing Codes​

Generate a new connection code:

remi code --refresh
New permanent connection code: CDWX-5678
Restart the daemon for the new code to take effect.

The new code takes effect after restarting the daemon or starting a new remi session.

note

The connection code is only active when a Remi daemon is running with --permanent-code. Generating a code does not start the daemon.

Code Format​

Connection codes follow the format XXXX-YYYY:

  • XXXX - 4 uppercase letters (excluding I, O, L to avoid confusion with digits)
  • YYYY - 4 digits (excluding 0 and 1 to avoid confusion with letters)

Examples: AXBY-2345, CDWX-6789, EFGH-3456

Rotating vs Permanent Codes​

By default, Remi generates rotating codes that change each time a relay peer disconnects. This provides ephemeral access without requiring Ed25519 authentication over the relay.

With --permanent-code, the code persists in ~/.remi/connection-code and survives daemon restarts. Permanent codes require full Ed25519 mutual authentication for every connection.

See Remote Access Guide for details on when to use each mode.