This project is read-only.


Add an Offline option or smarter cache


When was offline today I was in a bad spot. I ended up using the local cache but I doubt that's easy to understand for the average joe. Why not include either a fallback option or an "-offline" choice or both?
Closed Jan 30, 2014 at 6:24 PM by RanjiniM


sparrez wrote Mar 9, 2012 at 8:18 PM

Like the idea. What about letting the user choose where the cache is placed, so I could put it in dropbox and have it available across dev machines. Don't know if it's possible, but I needed a package I knew was on my home machine, but not on my new work laptop, so was pretty screwed and ended up downloading the dll's manually. Did not like that ONE BIT! :)

gregmac wrote Mar 9, 2012 at 8:22 PM

Why is it necessary to rely on at all for anything besides updates or new packages? NuGet uses the cache now presumably to not re-download a package it already has. I assume that it's still hitting to figure out that when I say I need SomePackage 1.3.5 it needs SomePackage.1.3.5.nupkg.. so why not just have a "built-in" behvaviour that it looks at the local cache first? This will reduce load on, and at the same time give offline support.

In a way I'm suggesting that the local cache folder should always be used as the primary package source (without requiring explicit configuration). This means that even if your source is an internal server, network share, or other private source you still get offline support.

sparrez wrote Mar 9, 2012 at 9:23 PM

@gregmac, good point. It could check if was available and if not fall back to the cache if the package was available there.

orionnoir wrote Mar 9, 2012 at 10:08 PM

I develop on disconnected/'never connected' networks frequently (luckily I get a reprieve, but I know many who do not.) Having a way to work offline is critical for inclusion of development technologies on those projects. There will never be a time that I am connected in those development environments. It may not be optimal in today's 'implicitly expected connected' world, but I soldier up to the plate and deal. Sadly a lot of good tech gets passed over. Imagine life without NuGet... Now please consider raising the impact level a pinch (not just because I asked nicely!)

cmkeller69 wrote Mar 9, 2012 at 10:34 PM

I work for the government. (boo! hiss!) Because of this, our development network is NOT connected (in any way) to the outside world. The assumption that everyone is 'always online' is a fallacy; I'd even argue the point in the civilian world. Just because something can does not mean it will always be 'online'. I recognize that this is a problem throughout the industry, but it is a significantly more serious issue for developers evangelizing the Microsoft stack in a closed environment. Please consider making this a priority. Thank you!

derekgreer wrote Mar 9, 2012 at 11:39 PM

This definitely deserves some attention. I wouldn't say it needs to be a fallback or an option so much as the cache needs to be the first place checked if a version number is specified. On a slightly related topic, workitem 1614 needs some love too:

adamralph wrote Mar 10, 2012 at 9:13 AM

At my current client site, accessing can be rather slow at times and there are even occasional network outages. Being able to use NuGet in an offline mode would be really useful in that context.

romainm wrote Mar 10, 2012 at 12:02 PM

I agree with @gregmac. I also think that nuget deserve a server solution that could handle situation like "I have a local nuget server to share enterprise wide packages", "the server retains all the packages we use, so even if a package disapear on nuget, we have it internally" and "the server works as a proxy, and if a new package is downloaded, the server retains it".

fmorriso wrote Mar 10, 2012 at 12:57 PM

The same reason Visual Studio gives me a choice of local vs. online Help (or a combination of both with the ability to choose which one to try first) is the reason why Visual Studio should provide me a choice of local (which I would assume means cache) vs. online NuGet via an EXPLICIT, VISIBILE way to choose (or a combination of both with the ability to choose which one to try first). Keep things consistent.

efalsken wrote Mar 10, 2012 at 6:16 PM

+1 for Airplane mode!

bizcad wrote Mar 10, 2012 at 8:50 PM

A local cache should also have the ability to get the latest version, so my team would always be up-to-date.

deburdett wrote Mar 10, 2012 at 11:29 PM

I vote for an automatic fallback to cache version: maybe with a notice, so you know you may not be getting the latest version until the server is back up or more normal my laptop is back on line.

Kiliman wrote Mar 11, 2012 at 3:39 PM

I agree with @gregmac. The only time you should rely on the main feed is when installing or updating packages. And this should be an explicit action. If you have a CI build server and you are using Package Restore, you should have a local package source. Your build process should not depend on an external repository. As we saw, this caused a lot of problems.

oatkins wrote Mar 12, 2012 at 1:25 PM

As another user who works on an Internet-disconnected network it is troubling to see Microsoft release some key updates (EF) only through Nuget. We create a local repository to get around this, but would like to see that as an integral function of the program rather than requiring reference to rather obscure blog posts.

pcasagrande wrote Mar 12, 2012 at 2:05 PM

A fail-over to the cache would be sufficient for my purposes.

simonmsm wrote Mar 12, 2012 at 4:30 PM

+1 for a local cache. How about a .\packages\cache directory that contains all the .nupkg files. e.g:


You could then remove the .nupkg files from under each package directory (e.g. .\packages\NUnit.\NUnit.

gregmac wrote Mar 12, 2012 at 4:52 PM

@simonmsm within a local dir is a bad idea for cache, because it won't help with build servers that do a clean and remove everything before building. There is also no point in caching the same version of the same page 10 times if you happen to have 10 products/versions checked out that all happen to use it.

TomHamilton wrote Mar 12, 2012 at 8:19 PM

I am in favor of an 'auto-fail over' that will engage the cached version and poll the NuGet server at interval x, notify user when the live NuGet is back online and check/verify whether the requisite packages have an update.
Personally my package build structure includes an archive folder that could just as well also support what are essentailly 'archive versions of NuGet packages'. User Configurable location would be a good thing. Thanks for listening

jadebird wrote Mar 12, 2012 at 11:19 PM

This offline option will be very useful.

JeffHandley wrote Mar 13, 2012 at 9:36 PM

We will be considering this with NuGet 1.9.

JeffHandley wrote Mar 13, 2012 at 9:37 PM

And for the record, we apologize for the inconvenience we caused you, Scott. :-) Great recovery though!

grhm wrote Mar 16, 2012 at 2:27 PM

I too work on networks that are never connected the the outside world. Whilst NuGet looks interesting, we have not tried it as we believe it insists on a internet connection. Adding offline support would allow this technology to be used by more developers.

derekgreer wrote Mar 16, 2012 at 2:54 PM

@grhm, You can use NuGet without connecting to the Internet, you just need to set up your own private NuGet Server (see: and configure NuGet to only use this server as the source.

GCATNM wrote Mar 17, 2012 at 11:49 PM

@derekgreer What is that server needed for? I'm simply using a UNC share for our internal packages, and that does everything I can imagine wanting a NuGet repository to do without an Internet connection.

cmkeller69 wrote Mar 18, 2012 at 12:35 AM

@derekgreer wonderful. Could you point to the documentation? A casual peek at the NuGet doc page did not appear to speak to this scenario so am hoping you have details. Specifically, how do I download the packages from Microsoft and get them onto 'my' server? I can't stand up a server and connect to the Internet at all, the network is closed. I have to actually move packages via DVD or some other medium. My entire point is that this should not be an issue. The assumption that everyone is connected is quite the stretch.

cmkeller69 wrote Mar 19, 2012 at 9:40 AM

@derekgreer disregard last... now that I've had time to visit the documentation more closely I found what you were describing.

delliott wrote Mar 20, 2012 at 8:26 PM

I develop for sites that cannot be connected to the internet for security reasons. Being able to deploy from a local share would be very helpful.

BrianNoyes wrote Apr 21, 2012 at 8:37 PM

Funny, was just on a plane and was screwed today. When I landed I start to write Scott H a note to ask how to handle this and then did a search and found his post. Guess my instincts were right on 1) Who would know how to deal with it, and 2) It is a scenario that should be better addressed.

mcassidy wrote May 25, 2012 at 10:58 PM

I also agree with the @gregmac (and more specifically, @romainm & @Kiliman) solution.

Project needs a package, but it's not there...
Package Restore looks in C:\ConfigurableLocation\LocalNugetCache\
but can't find it,
so it looks in \FileServer\DepartmentalNugetCache
but can't find it,
so it looks in
Here it can't find it, but this is the first true "cache" we come across in the hierarchy, so this nuget server would automatically go get it from, store it for the future, and pass it back to my machine.
But say that site was unavailable, my local nuget would still know to continue on...
so it looks in
and finds it!

When my local nuget gets it, it automatically stores it in all the passive caches in the chain (the first two in this example).

The hierarchy should be configurable at the project level, with optional defaults at the solution-level and machine-level.

Each cache can also optionally know about its parent source, via a .nuget_source file, so when we look in \FileServer\DepartmentalNugetCache we don't find anything, so we check for the existance of \FileServer\DepartmentalNugetCache.nuget_source and find more branches to go searching, which may or may not be the same as our locally configured hierarchy.

I just used package restore as an example. It should obviously work for adding new packages, too.

Did I overthink this? :)

johncrim wrote May 29, 2012 at 7:21 AM

I vote for both an -offline option (fail-over to whatever is in %LOCALAPPDATA%\NuGet\Cache), and persistent caching proxy support for a NuGet server (I believe there's already a case for this). I think those are separate features and both useful for different reasons.

jarrettmeyer wrote Jun 27, 2012 at 2:17 PM

Why let users intervene at all? I like this idea, but wish NuGet acted more like Ruby gems and bundler. If you've downloaded a gem, it first goes to a local gem store for a copy. If the requested gem is not found, then it is downloaded from the online gem store.

Example: I should only download MyPackage-0.0.1 exactly one time. It is copied to my local cache and my project. I start a new project, and that also needs MyPackage-0.0.1. Nothing should be downloaded.

pranavkm wrote Jun 27, 2012 at 5:41 PM

We already have a machine cache that is used during package restore (probably the most CI breaking scenario) and is in fact treated as a first class package repository. What wouldn't work is installing new packages etc

@sparrez - We already support custom locations for the package cache. It's not documented well enough, but you can specify a custom location by specifying an environment variable named "NuGetCachePath"

@gregmac - For new installs, we try our best to honor unlisting of packages or the worst case scenario of someone altering the nupkg on the server. For package restore, we do use the local cache.

We could certainly make it simpler by allowing the nuget.exe install command to install all dependencies too (it does not resolve dependencies today). Beyond that simply tinkering with the package source gets nearly all the asks in this thread.

gregmac wrote Mar 16, 2013 at 3:07 AM

There's a workaround to effectively implement this, which is to add/modify your .nuget\NuGet.Config file to contain the following:
<?xml version="1.0" encoding="utf-8"?>
    <add key="Local NuGet cache" value="%localappdata%\NuGet\Cache" />
    <add key="NuGet official package source" value="" />
  <disabledPackageSources />
    <add key="All" value="(Aggregate source)"  />
This makes the local cache the primary source, followed by the official site. I tested by blocking without and then with this fix, but I haven't had it in place during an actual failure yet. I didn't check but I assume this also means it doesn't hit at all unless there's a package that hasn't been downloaded yet, which should speed up builds and especially help for those of using CI and building dozens of times a day -- not to mention reduce the traffic for

I have to say, I'm still surprised this isn't the default way NuGet works.

zendu wrote Nov 22, 2013 at 10:17 AM

I think that the nuget packages should be available offline. There could be multiple levels of caching - at machine level, project level, department/unit level, organization level, and ultimately When a package is not found in a cache, higher level cache should be tried and whenever a package is found, it should be cached at subsequent lower caches. Of course, one should be able to control size of cache at each level.
I have seen this concept implemented in Windows Debuggers - they call it daisy chaining of symbols.
Another way could be like WSUS server - wherein Windows Updates are downloaded from Microsoft and made available to all machines in the organization. So that each machine does not have to hit Internet to get updates.

danliu wrote Nov 22, 2013 at 6:14 PM


Limited support has been added to the next release of NuGet, i.e. checking machine level cache when other sources fail. Please note that machine cache only has the latest 200 packages, so it will help some offline install scenarios.

To give it a try, please download the VSIXes below and let us know your feedback. Thanks!

VSIX for VS 2013:

VSIX for VS 2010 and VS 2012:

RanjiniM wrote Jan 30, 2014 at 6:24 PM

Falling back to Cache when all other sources fail during Install-Package has been added in NuGet 2.8 release.

mcassidy wrote Apr 2, 2014 at 3:09 PM

Yeah, but based on today's evidence, it doesn't work. I've got NUnit in my cache...
C:\>dir /b C:\Users\me\AppData\Local\NuGet\Cache\NUnit.2.6.3.nupkg
but get this error PMC...
PM> Install-Package NUnit -Version 2.6.3
Install-Package : Unable to find version '2.6.3' of package 'NUnit'.
At line:1 char:1
+ Install-Package NUnit -Version 2.6.3
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [Install-Package], InvalidOperationException
    + FullyQualifiedErrorId : NuGetCmdletUnhandledException,NuGet.PowerShell.Commands.InstallPackageCommand

mcassidy wrote Apr 2, 2014 at 3:29 PM

At least package restore is working fine from cache.

danliu wrote Apr 2, 2014 at 5:36 PM

@mcassidy, what is the selected package source on your PMC.

mcassidy wrote Apr 2, 2014 at 7:05 PM

Sorry, "All". I realised after the fact I should have mentioned that, but couldn't figure out a way to edit my comment and didn't want to keep spamming new replies :(

PMC Host Version is 2.8.50126.477

%APPDATA%\NuGet\Nuget.config contents is:
<?xml version="1.0" encoding="utf-8"?>
    <add key="enabled" value="True" />
    <add key="automatic" value="True" />
    <add key="" value="" />
    <add key="MyCustomFeed" value="\\MyFileServer\Tools\MyCustomFeed" />
  <disabledPackageSources />
    <add key="All" value="(Aggregate source)" />

danliu wrote Apr 16, 2014 at 12:21 AM

@mcassidy, I think you may be hitting this known issue -