Unofficial FAQ for trying Radicle

clearloop · March 8, 2021, 4:15pm

There should be somewhere gathering problems that new users might meet but the old ones have already met and solved since Radicle is on the way to β2

Current Status: β1 Release Preparation · GitHub
Official FAQ: https://docs.radicle.xyz/docs/understanding-radicle/faq

0. could not log in

First of all, make sure you’re using the latest version, https://radicle.xyz/downloads.html

1. how to reset profile / remove repos

Radicle doesn’t support deleting repos for now, but if you want to reset profile/state, check this script:

github.com

radicle-dev/radicle-upstream/blob/main/scripts/reset-state.sh

#!/usr/bin/env bash

# Copyright © 2021 The Radicle Upstream Contributors
#
# This file is part of radicle-upstream, distributed under the GPLv3
# with Radicle Linking Exception. For full terms see the included
# LICENSE file.

set -eou pipefail

platform="$(uname)"
declare -a dirs;
if [ "$platform" == "Darwin" ]; then
    dirs=(
        "$HOME/.radicle"
        "$HOME/Library/Application Support/Radicle Upstream"
        "$HOME/Library/Application Support/xyz.radicle.radicle"
        "$HOME/Library/Application Support/xyz.radicle.radicle-link"
        "$HOME/Library/Application Support/xyz.radicle.radicle-upstream"
        "$HOME/Library/Preferences/xyz.radicle.radicle-upstream.plist"

This file has been truncated. show original

Related discussion on discourse:

2. problems while setting up a seed node

First of all, you might want to read this docs https://docs.radicle.xyz/docs/using-radicle/running-a-seed-node

And if you’re not familiar with the command-line but still want to set up a seed node, try to follow the PR https://github.com/radicle-dev/radicle-bins/pull/61, it will provide Dockerfile and systemd script.

3. could not connect to the seed nodes

This is actually which step I’m stuck at currently now, here is the linked issue on GitHub Some tools for checking or logging the p2p status of the upstream · Issue #1657 · radicle-dev/radicle-upstream · GitHub

How can I make my seed node appear "online" on "seedling.radicle.xyz"

4. Windows version

Radicle Upstream doesn’t have windows version for now, please track the issue Add support for Windows · Issue #1488 · radicle-dev/radicle-upstream · GitHub

Welcome to provide more problems you met or solved while you trying radicle, list behind, and I’m willing to gather them to the top.

clearloop · March 9, 2021, 4:22pm

The status in the top post is passed, for the roadmap of the radicle project

All projects:

As a limit of discourse, I can’t edit the top post too many times, there must be some way to do this thing better.

abbey · March 19, 2021, 11:35am

Hmmm, maybe we should just try to merge this with the FAQ in the docs then and make it easier to contribute? I’d love to keep this updated, and don’t want it to be limited by Discourse.

What do you think?

clearloop · March 19, 2021, 6:53pm

I just have no idea how to merge, the format and purpose are different, the FAQ is clean and tiny and this is verbose LOL

I was considering adding this to radicle-unofficial · GitHub

maybe we should just try to merge this with the FAQ in the docs then and make it easier to contribute?

Or you are saying, we can link github issues in the FAQ? I can open a PR to the docs repo and trying to do that this weekend