Opened 6 years ago

Closed 15 months ago

#11289 closed enhancement (fixed)

FAQ entry for where Tor's data directory is

Reported by: atagar Owned by: mttp
Priority: Very Low Milestone: WebsiteV3
Component: Webpages/Website Version:
Severity: Normal Keywords: website-content, FAQ
Cc: mttp Actual Points:
Parent ID: Points:
Reviewer: Sponsor:

Description

I just took a peek in our faqs to see if there was a "Where is my data directory?" entry I could link to. We don't seem to have one, and tor's man page says "Store working data in DIR (Default: @LOCALSTATEDIR@/lib/tor)". I have no clue what that macro expands to, nor would I expect users to. :)

If we can't clarify the manual page then this seems like something we should include in our FAQ since it in turn defines the path of our authentication cookie among other things.

Child Tickets

Change History (13)

comment:1 Changed 6 years ago by arma

Cc: mttp added

Sounds good to me; it could go right under https://www.torproject.org/docs/faq#torrc

The answer is that for TBB it's Data/Tor/, and for most system packages it's /var/lib/tor/

(What other systems have different answers?)

comment:2 Changed 6 years ago by mttp

I have a $USER/.tor directory and a /var/lib/tor directory, but the latter has newer information. I'm wondering if it's normal to have both directories.

The sample torrc file's explanation of the DataDirectory entry says "By default, we store things in $HOME/.tor on Unix". Is this still accurate? (Because it sounds like you just said something else.)

It's /usr/local/var/lib/tor if you compile from source, right?

How do you feel about adding a section division at the bottom of the web man page with some typical values for @CONFDIR@ and @LOCALSTATEDIR@?

Last edited 6 years ago by mttp (previous) (diff)

comment:3 Changed 6 years ago by mttp

Owner: set to mttp
Status: newassigned

comment:4 Changed 6 years ago by mttp

Status: assignedneeds_information

comment:5 Changed 2 years ago by hiro

Keywords: website-content added
Milestone: WebsiteV3
Severity: Normal

comment:6 Changed 15 months ago by traumschule

Keywords: FAQ added; website-content removed

comment:7 Changed 15 months ago by traumschule

Keywords: website-content added

comment:8 Changed 15 months ago by traumschule

Status: needs_informationneeds_review

I created a PR with a sentence in the #torrc section:
https://github.com/torproject/webwml/pull/23

It is also mentioned under #ConfigureRelayOrBridge:

Second (complex option), you can edit your torrc file (in Data/Tor/torrc)

And #torrc had:

If you installed Tor Browser on Windows or Linux, look for

<code>Browser/TorBrowser/Data/Tor/torrc</code> inside your Tor Browser
directory.

comment:9 Changed 15 months ago by teor

Status: needs_reviewneeds_revision

The data directory answer doesn't cover all the possible data directory locations.
For example, it's missing the macOS TBB location.
Please provide the data directory location for every torrc location mentioned in the torrc section.

You also added the $HOME/.tor data directory location, but there's no corresponding torrc location.

But if you duplicate all the TBB information, it might get out of sync.

It might be better to update each torrc alternative so that it covers the data directory as well.

For example:

  • If you installed Tor Browser on Windows or Linux, the torrc file is in the data directory, which is Browser/TorBrowser/Data/Tor inside your Tor Browser directory.
  • Otherwise, if you are using Tor without Tor Browser … package. For most systems, the data directory is /var/lib/tor/.

Please also consistently use code tags throughout the answer, rather than using var tags for new content.

Edit: undo autocorrect

Last edited 15 months ago by teor (previous) (diff)

comment:10 Changed 15 months ago by traumschule

Status: needs_revisionneeds_review

You convinced me to do this right but I needed a procastination commit first - don't waste your time with it :)
(same PR, link above)

comment:11 Changed 15 months ago by teor

It's really hard for me to review your commits, because you have made too many changes per commit.

Please:

  • do your indenting using a script, so I can verify the results
  • split the following changes into one commit each
    • linked first occurrence of torrc in every answer to #torrc
    • replaced absolute links to torproject.org with relative ones
    • added TODO to questions in html comments

comment:12 Changed 15 months ago by teor

Status: needs_reviewneeds_revision

comment:13 Changed 15 months ago by traumschule

Resolution: fixed
Status: needs_revisionclosed

this got merged, please reopen if you are not fine with this.

Note: See TracTickets for help on using tickets.