edgemail - GitLite

KO | EN

gitlite — search

#python #ai #typescript #android #rust #deep-learning #docker #windows #awesome #kubernetes #pytorch #security #mcp #open-source

edgemail

(★ 289)

No description available.

File Explorer

Download Latest Version (.zip)

- android-chrome-192x192.png
- android-chrome-512x512.png
- apple-touch-icon.png
- favicon-16x16.png
- favicon-32x32.png
- favicon.ico
- inbox.html
- inbox.js
- index.html
- login.js
- api.rs
- database.rs
- lib.rs
- main.rs
- smtp.rs
- payload.py
.dockerignore
.gitignore
Cargo.toml
Dockerfile
fly.toml
LICENSE
LICENSE-APACHE2.0
README.md
SKILL.md

# Installation Guide

1. Get the code

git clone https://github.com/psarna/edgemail

Downloads the entire project code from GitHub to your computer.

cd edgemail

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

docker build -t edgemail .

Builds a runnable image based on the Dockerfile.

docker run -p 8080:80 edgemail

Runs the built image as an actual container.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

3. Rust

Medium

Prerequisites

Git Needed to download the project code from GitHub.
Rust (rustup) Installing via rustup also installs cargo.

cargo build --release

Compiles the Rust project.

cargo run

Builds and then immediately runs the program.

✅ If cargo build finishes without errors, it worked. The executable is created under target/.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# edgemail

A professional, production-grade SMTP server! No it's not.
This demo project implements a very simple temporary e-mail, capable of receiving e-mails and storing them in [libSQL](https://github.com/libsql/libsql) (locally), [sqld](https://github.com/libsql/sqld), or [Turso](https://chiselstrike.com).

Tutorial: [Write your own email server in Rust](https://blog.turso.tech/write-your-own-email-server-in-rust-36f4ff5b1956)

Example deployment: https://sorry.idont.date/

In order to get it to work, run it on a machine with public IP, port `25` exposed, and add all appropriate DNS entries - an `MX` entry and its corresponding `A` entry that points to the IP address where `edgemail` is deployed.

## inbox api

If you start `edgemail` with `--api-port <port>`, it also serves a JSON API on that port.

- `GET /inbox?inbox=<email@domain>&page=<n>` returns `{ mail, has_more_pages }`, where `mail` contains up to 10 messages with `date`, `recipients`, `sender`, `subject`, and `id`; `page` defaults to `1`
- `GET /inbox/<id>` returns a single message with `id`, `date`, `recipients`, `sender`, `subject`, and `body`
- after 100 API requests have been served, later requests return `503 Service Unavailable`
- API requests time out after 30 seconds and return `504 Gateway Timeout`

## client

edgemail has a client you can run as a static webpage. Find all the files in client/ directory. The only thing that needs to be changed is the database URL and the `readonly_token` used to authenticate for read-only access.