Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ We welcome contributions to Freenet! Here's what you need to know.

- **Claim the issue first.** Comment on the issue you want to work on and wait for a maintainer to confirm before starting work. This prevents duplicate effort and ensures the approach is aligned with project direction.
- **Read the codebase conventions.** See [AGENTS.md](AGENTS.md) for project structure, coding standards, and testing requirements.
- **Ask questions.** If something is unclear, ask on the issue or in our [Matrix channel](https://matrix.to/#/#freenet:matrix.org) before writing code.
- **Ask questions.** If something is unclear, ask on the issue or in our [Matrix channel](https://matrix.to/#/#freenet-locutus:matrix.org) before writing code.

## Quality Standards

Expand All @@ -31,7 +31,7 @@ We require the use of a frontier-class model (as of early 2026: Claude Opus 4, G

## Getting Help

- [Matrix chat](https://matrix.to/#/#freenet:matrix.org) for questions and discussion
- [Matrix chat](https://matrix.to/#/#freenet-locutus:matrix.org) for questions and discussion
- [Issue tracker](https://github.com/freenet/freenet-core/issues) for bugs and feature requests
- [API docs](https://docs.rs/freenet) for code reference
- [Freenet manual](https://freenet.org/resources/manual/) for architecture overview
3 changes: 2 additions & 1 deletion hugo-site/content/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -131,6 +131,7 @@ just a few hops, scaling efficiently to millions of peers, no servers required.

[River](/river/) · [Apps](/apps/) · [Video Talks](/about/video-talks/) ·
[Matrix Chat](https://matrix.to/#/#freenet-locutus:matrix.org) ·
[GitHub](https://github.com/freenet/freenet-core) · [FAQ](/about/faq/)
[GitHub](https://github.com/freenet/freenet-core) · [FAQ](/about/faq/) ·
[Report a Bug](/community/support/)

</div>
2 changes: 1 addition & 1 deletion hugo-site/content/build/manual/community.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@ aliases:
---

- [Github](https://github.com/freenet/freenet-core)
- [Matrix](https://matrix.to/#/#locutus:matrix.org)
- [Matrix](https://matrix.to/#/#freenet-locutus:matrix.org)
5 changes: 5 additions & 0 deletions hugo-site/content/community/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "Community"
date: 2026-08-25
draft: false
---
5 changes: 0 additions & 5 deletions hugo-site/content/community/get-involved/index.md

This file was deleted.

126 changes: 124 additions & 2 deletions hugo-site/content/community/support/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,127 @@
---
title: "Support"
date: 2024-06-11T00:00:00Z
title: "Report a Bug or Get Help"
description:
"Where to report a Freenet bug or ask for a feature: which project, which issue tracker, and what
to include."
date: 2026-08-25
draft: false
aliases:
- /report/
- /community/get-involved/
---

Found a bug, or want something Freenet doesn't do yet? Please tell us. This page points you at the
right place to say it.

Freenet is a network plus a set of separate apps built on top of it, and each one keeps its own list
of bugs. So the first step is picking which one you were using. If you pick wrong, we'll move your
report for you.

Filing a report on GitHub needs a free GitHub account. If you'd rather not create one, say it in
[our Matrix room](https://matrix.to/#/#freenet-locutus:matrix.org) instead and someone will file it
for you.

## What were you using?

### Group chat (River)

Messages not sending, a room that won't load, an invite that doesn't work, members missing, anything
in the chat interface itself.

→ [Report a River bug](https://github.com/freenet/river/issues/new) ·
[existing River issues](https://github.com/freenet/river/issues)

### Freenet itself

Install or uninstall trouble, the node won't start or won't stay running, no connections, high CPU
or bandwidth use, the menu bar or system tray icon, errors from the `freenet` command. Anything
underneath the apps rather than inside one.

→ [Report a Freenet bug](https://github.com/freenet/freenet-core/issues/new) ·
[existing Freenet issues](https://github.com/freenet/freenet-core/issues)

### This website

A broken link, documentation that's wrong or confusing, a page that won't load, a typo.

→ [Report a website bug](https://github.com/freenet/web/issues/new) ·
[existing website issues](https://github.com/freenet/web/issues)

### Ghost Keys

Trouble with the Ghostkey Vault: importing a key, backing one up, an app that can't get a signature.

→ [Report a Ghostkey Vault bug](https://github.com/freenet/ghostkeys/issues/new) ·
[existing Ghostkey Vault issues](https://github.com/freenet/ghostkeys/issues)

A donation that didn't go through, or a Ghost Key certificate that never arrived, is handled by this
website rather than by the vault, so [report those here](https://github.com/freenet/web/issues/new).

### One of the other apps

Each keeps its own list: [Delta](https://github.com/freenet/delta/issues/new),
[Mail](https://github.com/freenet/mail/issues/new),
[freenet-git](https://github.com/freenet/freenet-git/issues/new),
[Raven](https://github.com/freenet/raven/issues/new),
[Atlas](https://github.com/freenet/atlas/issues/new) and
[Harvest](https://github.com/freenet/harvest/issues/new). The [apps page](/apps/) says what each one
does, if you're not sure which you were using.

### Not sure

Use the [Freenet issue tracker](https://github.com/freenet/freenet-core/issues/new). It's the one
the maintainers watch most closely, and they'll move your report if it belongs somewhere else.
Describing clearly what happened matters far more than landing it in the right place the first time.

If you'd rather have someone work it out with you, ask in
[Matrix](https://matrix.to/#/#freenet-locutus:matrix.org).

## What to put in a bug report

You don't need to diagnose the problem. What makes a report easy to act on:

- What you were doing, what you expected, and what happened instead.
- Whether it happens every time or only sometimes.
- Your operating system, and how you installed Freenet.
- A screenshot, if it's something you can see.

### The quick way to gather diagnostics

If Freenet is installed on your machine, run this in a terminal:

```bash
freenet service report
```

It gathers your version, operating system, recent log entries and configuration, then asks you to
describe the problem, uploads everything, and prints a short **report code** that looks like
`X7K2M9`. Put that code in your bug report and the maintainers can pull up everything they need. If
your node isn't answering, that step waits up to a minute before giving up, so the prompt may take a
while to appear.

That upload is more than logs, so it's worth knowing what's in it: your machine's hostname, recent
log lines, your Freenet configuration file (which includes paths containing your username), and, if
your node is running, its current network state. That state covers your peer ID, the addresses of
the peers you're connected to, and every contract your node holds. For River that includes the rooms
you're in.

Your IP address is recorded when the upload is received.

If you'd rather read all of that before sending it, `freenet service report --local report.json`
writes the same bundle to a file on your own machine and uploads nothing. There's no way to send a
saved file afterwards, so once you're happy with it, run the command again without `--local` and it
will collect a fresh copy of the same things.

## Prefer to talk to a person?

Our [Matrix room](https://matrix.to/#/#freenet-locutus:matrix.org) is where Freenet's developers and
users are. It's a good place for "is this even a bug?", for questions the FAQ doesn't answer, and
for anything you'd rather not write up as a formal report.

## Want to help fix things?

A clear bug report is already a real contribution. If you want to go further,
[freenet-core's contributing guide](https://github.com/freenet/freenet-core/blob/main/CONTRIBUTING.md)
explains how the project takes changes. Read it before you write any code: feature work needs an
agreed issue first, and pull requests that skip that step get closed. The [Build section](/build/)
covers how Freenet works and how to write apps for it.
2 changes: 1 addition & 1 deletion hugo-site/content/donate/thanks/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,6 @@ are tax-deductible in the United States.

### Stay connected

- Join the conversation on [Matrix](https://matrix.to/#/#freenet:matrix.org)
- Join the conversation on [Matrix](https://matrix.to/#/#freenet-locutus:matrix.org)
- Follow project updates on [our news page](/about/news/)
- Read about the architecture in the [whitepaper](/whitepaper/)
4 changes: 2 additions & 2 deletions hugo-site/content/quickstart/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Prefer the terminal? River has a full-featured CLI, `riverctl`. See the
## Troubleshooting

If you run into problems, join our [Matrix chat](https://matrix.to/#/#freenet-locutus:matrix.org)
for help.
for help, or see [Report a Bug or Get Help](/community/support/) for where to file a report.

**Invite didn't work?** If River opened but you're not in the room, try restarting Freenet
(`freenet service restart`), then come back to this page and click the invite button again for a
Expand All @@ -67,4 +67,4 @@ Need to remove Freenet? See the [uninstall guide](/uninstall/).
- [User Manual](/build/manual/) - Learn how Freenet works
- [Video Talks](/about/video-talks/) - Watch presentations about Freenet
- [FAQ](/about/faq/) - Common questions and answers
- [Get Involved](/community/get-involved/) - Contribute to the project
- [Report a Bug or Get Help](/community/support/) - Where to send a bug report or feature idea
4 changes: 2 additions & 2 deletions hugo-site/static/slides/common/call-to-action.html
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ <h2 style="flex-shrink: 0; margin-bottom: 0.3em;">Get Involved</h2>
<p style="font-size: 0.75em; color: rgba(255,255,255,0.6);">
<a href="https://freenet.org" style="color: #4facfe; margin: 0 0.8em;">freenet.org</a>
<a href="https://github.com/freenet" style="color: #4facfe; margin: 0 0.8em;">GitHub</a>
<a href="https://matrix.to/#/#freenet:matrix.org" style="color: #4facfe; margin: 0 0.8em;">Matrix</a>
<a href="https://matrix.to/#/#freenet-locutus:matrix.org" style="color: #4facfe; margin: 0 0.8em;">Matrix</a>
</p>
</div>
</div>
Expand All @@ -45,7 +45,7 @@ <h2 style="flex-shrink: 0; margin-bottom: 0.3em;">Get Involved</h2>
<li>Run a peer: freenet.org/quickstart</li>
<li>Build: tutorial at freenet.org/resources/manual/tutorial, uses River as example</li>
<li>AI: dapp-builder skill for Claude</li>
<li>Matrix: #freenet:matrix.org</li>
<li>Matrix: #freenet-locutus:matrix.org</li>
</ul>
</aside>
</section>
2 changes: 1 addition & 1 deletion hugo-site/static/slides/common/questions.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ <h1 style="font-size: 3em; background: linear-gradient(90deg, #4facfe, #43e97b);
</p>
<p style="margin: 0.8em 0;">
<span style="color: #43e97b;">💬</span>
<a href="https://matrix.to/#/#freenet:matrix.org" style="color: rgba(255,255,255,0.8); margin-left: 0.5em;">Matrix: #freenet:matrix.org</a>
<a href="https://matrix.to/#/#freenet-locutus:matrix.org" style="color: rgba(255,255,255,0.8); margin-left: 0.5em;">Matrix: #freenet-locutus:matrix.org</a>
</p>
<p style="margin: 0.8em 0;">
<span style="color: #a855f7;">𝕏</span>
Expand Down
29 changes: 24 additions & 5 deletions hugo-site/themes/freenet/assets/css/freenet.css
Original file line number Diff line number Diff line change
Expand Up @@ -1107,6 +1107,20 @@ picture.app-screenshot img {
}
}

/* Bug-report route in the footer — the one support link present on every page,
so it has to read as a link rather than as a caption. Shares the quiet
underlined link treatment with .footer-institutional below. */
.footer-report {
text-align: center;
margin: 2rem auto 0;
padding: 0 1rem;
font-size: 0.9rem;
}

.footer-report p {
margin: 0;
}

/* Institutional statement in footer — quiet, just establishes 501(c)(3) status */
.footer-institutional {
max-width: 720px;
Expand All @@ -1122,29 +1136,34 @@ picture.app-screenshot img {
margin: 0;
}

.footer-institutional a {
.footer-institutional a,
.footer-report a {
color: #64748b;
text-decoration: underline;
text-decoration-color: rgba(100, 116, 139, 0.4);
text-underline-offset: 2px;
}

.footer-institutional a:hover {
.footer-institutional a:hover,
.footer-report a:hover {
color: var(--color-primary);
text-decoration-color: var(--color-primary);
}

@media (prefers-color-scheme: dark) {
.footer-institutional,
.footer-institutional a {
.footer-institutional a,
.footer-report a {
color: #94a3b8;
}

.footer-institutional a {
.footer-institutional a,
.footer-report a {
text-decoration-color: rgba(148, 163, 184, 0.4);
}

.footer-institutional a:hover {
.footer-institutional a:hover,
.footer-report a:hover {
color: #4da6ff;
text-decoration-color: #4da6ff;
}
Expand Down
3 changes: 3 additions & 0 deletions hugo-site/themes/freenet/layouts/partials/footer.html
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
<div class="footer-report">
<p><a href="/community/support/">Report a bug or get help</a></p>
</div>
<div class="footer-institutional">
<p>
Founded in 2001, Freenet is a 501(c)(3) nonprofit organization dedicated to the development
Expand Down
Loading