Skip to content

Add README.md#127

Open
peterjan wants to merge 5 commits intomasterfrom
pj/add-readme
Open

Add README.md#127
peterjan wants to merge 5 commits intomasterfrom
pj/add-readme

Conversation

@peterjan
Copy link
Copy Markdown
Member

@peterjan peterjan commented Apr 17, 2026

This PR adds a README

Close #113

@peterjan peterjan self-assigned this Apr 17, 2026
@github-project-automation github-project-automation Bot moved this to In Progress in Sia Apr 17, 2026
@peterjan
Copy link
Copy Markdown
Member Author

@ChrisSchinnerl , the issue mentions you want to get rid of S3D_DATA_DIR but that would actually make it inconsistent with our other daemons.

Repo YAML directory field *_DATA_DIR env var -dir CLI flag
indexd Yes INDEXD_DATA_DIR No
hostd No HOSTD_DATA_DIR Yes
s3d Yes S3D_DATA_DIR No

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a full project README to document what s3d is, how to build/run it, and its S3 feature coverage.

Changes:

  • Expanded README with overview, build instructions, and getting-started flow
  • Added Docker compose example and configuration reference (flags/paths/env vars)
  • Documented multipart uploads and an S3 compatibility matrix

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md
Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md
Comment thread README.md Outdated
Comment on lines +213 to +220
The following environment variables may be used to override the default
configuration and take precedence over the config file settings.

| Variable | Description |
|----------|-------------|
| `S3D_CONFIG_FILE` | Override the config file path |
| `S3D_DATA_DIR` | Override the data directory |
| `S3D_RECOVERY_PHRASE` | Set the wallet recovery phrase |
Copy link

Copilot AI Apr 17, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The text says environment variables “take precedence over the config file settings”, but LoadFile decodes YAML directly into cfg, which will overwrite values initially sourced from S3D_DATA_DIR/S3D_RECOVERY_PHRASE in main.go. Please reword this section to match actual precedence (env vars mainly affect default values / config path selection).

Suggested change
The following environment variables may be used to override the default
configuration and take precedence over the config file settings.
| Variable | Description |
|----------|-------------|
| `S3D_CONFIG_FILE` | Override the config file path |
| `S3D_DATA_DIR` | Override the data directory |
| `S3D_RECOVERY_PHRASE` | Set the wallet recovery phrase |
The following environment variables may be used to select the config file path
or provide default values before the config file is loaded. If the config file
also sets `directory` or `recoveryPhrase`, those file settings take precedence.
| Variable | Description |
|----------|-------------|
| `S3D_CONFIG_FILE` | Override the path of the config file to load |
| `S3D_DATA_DIR` | Set the default data directory if not specified in the config file |
| `S3D_RECOVERY_PHRASE` | Set the default wallet recovery phrase if not specified in the config file |

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Member Author

@peterjan peterjan Apr 17, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should probably change this so env variables take precedence over the config file... cc @ChrisSchinnerl

Comment thread README.md
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
Comment thread README.md Outdated
@peterjan peterjan marked this pull request as ready for review April 20, 2026 12:04
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md
Comment thread README.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: In Progress

Development

Successfully merging this pull request may close these issues.

Add a README

3 participants