ZOM (Zed Offline Mirror)

zom is a mirror server for Zed code editor.

Features

• Mirror of zed extensions (https://zed.dev/extensions)
• Mirror of zed updates, providing an offline standalone installer.
• Efficient synchronisation of new extensions.

Usage

Once deployed at http://<ZOM_SERVER>, you can use it in zed by adding the following in you configuration file:

"server_url": "http://<ZOM_SERVER>",

You can also install zed from this server:

curl http://<ZOM_SERVER>/install.sh | sh

or you can go to http://<ZOM_SERVER>.

Administration

zom works in two steps:

1. Synchronisation of the mirror.
2. Serving the mirror on HTTP.

Step 1 creates a directory structure for the mirror by connecting to an upstream. This directory is used by step 2 to serve the mirror.

# create the mirror by connecting to an upstream server (by default zed.dev).
zom sync -d /path/to/mirror

# serve the mirror on localhost:8080
zom serve -d /path/to/mirror -l localhost:8080

# prune downloaded artifacts on the mirror
zom prune -d /path/to/mirror

See zom sync --help, zom prune --help and zom serve --help for more options for these commands.

Also see zom --help for more options provided by the binary.

All options can also be provided using a toml configuration file, as provided in this repository config.toml.

Development

cargo run

Packaging

Debian

# install cargo deb <https://github.com/kornelski/cargo-deb>
# only required once
cargo install cargo-deb

# build the deb in target/debian
cargo deb